home *** CD-ROM | disk | FTP | other *** search
/ Total Network Tools 2002 / NextStepPublishing-TotalNetworkTools2002-Win95.iso / Archive / Misc Servers / Zope.exe / BASESTORAGE.PY < prev    next >
Encoding:
Python Source  |  2000-08-08  |  8.2 KB  |  233 lines
  1. ##############################################################################
  2. # 
  3. # Zope Public License (ZPL) Version 1.0
  4. # -------------------------------------
  5. # 
  6. # Copyright (c) Digital Creations.  All rights reserved.
  7. # 
  8. # This license has been certified as Open Source(tm).
  9. # 
  10. # Redistribution and use in source and binary forms, with or without
  11. # modification, are permitted provided that the following conditions are
  12. # met:
  13. # 
  14. # 1. Redistributions in source code must retain the above copyright
  15. #    notice, this list of conditions, and the following disclaimer.
  16. # 
  17. # 2. Redistributions in binary form must reproduce the above copyright
  18. #    notice, this list of conditions, and the following disclaimer in
  19. #    the documentation and/or other materials provided with the
  20. #    distribution.
  21. # 
  22. # 3. Digital Creations requests that attribution be given to Zope
  23. #    in any manner possible. Zope includes a "Powered by Zope"
  24. #    button that is installed by default. While it is not a license
  25. #    violation to remove this button, it is requested that the
  26. #    attribution remain. A significant investment has been put
  27. #    into Zope, and this effort will continue if the Zope community
  28. #    continues to grow. This is one way to assure that growth.
  29. # 
  30. # 4. All advertising materials and documentation mentioning
  31. #    features derived from or use of this software must display
  32. #    the following acknowledgement:
  33. # 
  34. #      "This product includes software developed by Digital Creations
  35. #      for use in the Z Object Publishing Environment
  36. #      (http://www.zope.org/)."
  37. # 
  38. #    In the event that the product being advertised includes an
  39. #    intact Zope distribution (with copyright and license included)
  40. #    then this clause is waived.
  41. # 
  42. # 5. Names associated with Zope or Digital Creations must not be used to
  43. #    endorse or promote products derived from this software without
  44. #    prior written permission from Digital Creations.
  45. # 
  46. # 6. Modified redistributions of any form whatsoever must retain
  47. #    the following acknowledgment:
  48. # 
  49. #      "This product includes software developed by Digital Creations
  50. #      for use in the Z Object Publishing Environment
  51. #      (http://www.zope.org/)."
  52. # 
  53. #    Intact (re-)distributions of any official Zope release do not
  54. #    require an external acknowledgement.
  55. # 
  56. # 7. Modifications are encouraged but must be packaged separately as
  57. #    patches to official Zope releases.  Distributions that do not
  58. #    clearly separate the patches from the original work must be clearly
  59. #    labeled as unofficial distributions.  Modifications which do not
  60. #    carry the name Zope may be packaged in any form, as long as they
  61. #    conform to all of the clauses above.
  62. # 
  63. # 
  64. # Disclaimer
  65. # 
  66. #   THIS SOFTWARE IS PROVIDED BY DIGITAL CREATIONS ``AS IS'' AND ANY
  67. #   EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  68. #   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  69. #   PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL DIGITAL CREATIONS OR ITS
  70. #   CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  71. #   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  72. #   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  73. #   USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  74. #   ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  75. #   OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  76. #   OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  77. #   SUCH DAMAGE.
  78. # 
  79. # 
  80. # This software consists of contributions made by Digital Creations and
  81. # many individuals on behalf of Digital Creations.  Specific
  82. # attributions are listed in the accompanying credits file.
  83. # 
  84. ##############################################################################
  85. """Handy standard storage machinery
  86. """
  87. __version__='$Revision: 1.7.12.1 $'[11:-2]
  88.  
  89.  
  90. import time, bpthread, UndoLogCompatible
  91. from POSException import UndoError
  92. from TimeStamp import TimeStamp
  93. z64='\0'*8
  94.  
  95. class BaseStorage(UndoLogCompatible.UndoLogCompatible):
  96.     _transaction=None
  97.     _serial=z64
  98.  
  99.     def __init__(self, name, base=None):
  100.         
  101.         self.__name__=name
  102.  
  103.         # Allocate locks:
  104.         l=bpthread.allocate_lock()
  105.         self._lock_acquire=l.acquire
  106.         self._lock_release=l.release
  107.         l=bpthread.allocate_lock()
  108.         self._commit_lock_acquire=l.acquire
  109.         self._commit_lock_release=l.release
  110.  
  111.         t=time.time()
  112.         t=self._ts=apply(TimeStamp,(time.gmtime(t)[:5]+(t%60,)))
  113.         self._serial=`t`
  114.         if base is None: self._oid='\0\0\0\0\0\0\0\0'
  115.         else:            self._oid=base._oid
  116.  
  117.     def abortVersion(self, src, transaction):
  118.         if transaction is not self._transaction:
  119.             raise POSException.StorageTransactionError(self, transaction)
  120.         return []
  121.  
  122.     def close(self): pass
  123.  
  124.     commitVersion=abortVersion
  125.  
  126.     def getName(self): return self.__name__
  127.     def getSize(self): return len(self)*300 # WAG!
  128.     def history(self, oid, version, length=1): pass
  129.                     
  130.     def modifiedInVersion(self, oid): return ''
  131.  
  132.     def new_oid(self, last=None):
  133.         if last is None:
  134.             self._lock_acquire()
  135.             try:
  136.                 last=self._oid
  137.                 d=ord(last[-1])
  138.                 if d < 255: last=last[:-1]+chr(d+1)
  139.                 else:       last=self.new_oid(last[:-1])
  140.                 self._oid=last
  141.                 return last
  142.             finally: self._lock_release()
  143.         else:
  144.             d=ord(last[-1])
  145.             if d < 255: return last[:-1]+chr(d+1)+'\0'*(8-len(last))
  146.             else:       return self.new_oid(last[:-1])
  147.  
  148.     def registerDB(self, db, limit): pass # we don't care
  149.  
  150.     def supportsUndo(self): return 0
  151.     def supportsVersions(self): return 0
  152.         
  153.     def tpc_abort(self, transaction):
  154.         self._lock_acquire()
  155.         try:
  156.             if transaction is not self._transaction: return
  157.             self._abort()
  158.             self._clear_temp()
  159.             self._transaction=None
  160.             self._commit_lock_release()
  161.         finally: self._lock_release()
  162.  
  163.     def _abort(self):
  164.         """Subclasses should rededine this to supply abort actions"""
  165.         pass
  166.  
  167.     def tpc_begin(self, transaction):
  168.         self._lock_acquire()
  169.         try:
  170.             if self._transaction is transaction: return
  171.             self._lock_release()
  172.             self._commit_lock_acquire()
  173.             self._lock_acquire()
  174.             self._transaction=transaction
  175.             self._clear_temp()
  176.  
  177.             user=transaction.user
  178.             desc=transaction.description
  179.             ext=transaction._extension
  180.             if ext: ext=dumps(ext,1)
  181.             else: ext=""
  182.             self._ude=user, desc, ext
  183.  
  184.             t=time.time()
  185.             t=apply(TimeStamp,(time.gmtime(t)[:5]+(t%60,)))
  186.             self._ts=t=t.laterThan(self._ts)
  187.             self._serial=`t`
  188.  
  189.             self._begin(self._serial, user, desc, ext)
  190.             
  191.         finally: self._lock_release()
  192.  
  193.     def _begin(self, tid, u, d, e):
  194.         """Subclasses should rededine this to supply
  195.         transaction start actions"""
  196.         pass
  197.  
  198.     def tpc_vote(self, transaction): pass
  199.  
  200.     def tpc_finish(self, transaction, f=None):
  201.         self._lock_acquire()
  202.         try:
  203.             if transaction is not self._transaction: return
  204.             if f is not None: f()
  205.  
  206.             u,d,e=self._ude
  207.             self._finish(self._serial, u, d, e)
  208.             self._clear_temp()
  209.         finally:
  210.             self._ude=None
  211.             self._transaction=None
  212.             self._commit_lock_release()
  213.             self._lock_release()
  214.  
  215.     def _finish(self, tid, u, d, e):
  216.         """Subclasses should rededine this to supply commit actions"""
  217.         pass
  218.  
  219.     def undo(self, transaction_id):
  220.         raise UndoError, 'non-undoable transaction'
  221.  
  222.     def undoLog(self, first, last, filter=None): return ()
  223.  
  224.     def versionEmpty(self, version): return 1
  225.  
  226.     def versions(self, max=None): return ()
  227.  
  228.     def pack(self, t, referencesf): pass
  229.  
  230.     def loadSerial(self, oid, serial):
  231.         raise POSException.Unsupported, (
  232.             "Retrieval of historical revisions is not supported")
  233.